#Claude Code Skills 才是未来

#概述

Skills 是 Claude Code 的扩展机制，通过简单的 Markdown 文件向 Claude 添加自定义能力。本文档介绍 Skills 的核心特性、安装方法、编写规范，以及为什么 Skills 比 MCP 更适合编码工作流程的编排和知识封装。

#Skills 简介

Skills 是 Claude Code 的扩展机制，通过 SKILL.md 文件向 Claude 添加自定义能力。

核心特性：

典型场景：

• 定义团队代码规范，Claude 自动遵循
• 封装重复任务，如组件生成、PR 审查

#安装位置

Skill 存放位置决定其作用范围：

目录结构：

my-skill/
├── SKILL.md           # 主文件（必需）
├── template.md        # 模板文件（可选）
└── scripts/
    └── helper.sh      # 辅助脚本（可选）

#SKILL.md 格式

SKILL.md 由两部分组成：YAML frontmatter 和 Markdown 内容。

---
name: review-code
description: 审查代码变更，检查规范和潜在问题
---

审查代码时遵循以下步骤：

1. 检查代码风格是否符合项目规范
2. 识别潜在的性能问题
3. 验证错误处理是否完整
4. 给出改进建议

Frontmatter 参数：

参数传递：

使用 $ARGUMENTS 或 $0、$1 获取调用参数：

---
name: fix-issue
description: 修复 GitHub Issue
---

修复 Issue #$0，遵循项目编码规范。

调用 /fix-issue 123 时，$0 替换为 123。

#实用示例

创建 ~/.claude/skills/commit/SKILL.md：

---
name: commit
description: 规范化 Git 提交
disable-model-invocation: true
---

执行 Git 提交：

1. 运行 `git status` 查看变更
2. 分析变更内容，生成符合 Conventional Commits 的提交信息
3. 格式：`<type>(<scope>): <description>`
4. type 可选：feat, fix, docs, refactor, test, chore
5. 执行提交

#安装与共享

mkdir -p ~/.claude/skills/my-skill
# 创建 SKILL.md 后立即生效

验证安装：

在 Claude Code 中输入：

/my-skill

或询问 Claude：

有哪些可用的 Skills？

#Skills 市场

社区提供了多个 Skills 市场，可直接安装现成的 Skill。

skills.sh 官方市场：

Vercel 推出的官方 CLI 工具和市场，支持多种 AI 代理工具。

# 安装 Skill
npx skills add <package-name>

浏览市场：https://skills.sh

支持的工具：Claude Code、Cursor、GitHub Copilot、Codex、Windsurf 等。

#使用 skill-creator 创建 Skills

Anthropic 官方提供了 skill-creator Skill，让 Claude 帮你编写高质量的 Skills。

安装：

npx skills add https://github.com/anthropics/skills --skill skill-creator

使用步骤：

#Skills vs MCP

Skills 和 MCP 代表了两种不同的 AI 扩展哲学。MCP 专注于连接外部系统，而 Skills 专注于编码工作流程和领域知识。

对比分析：

MCP 最大的痛点是上下文占用。社区反馈显示，连接 4 个 MCP 服务器可能消耗 67,000 tokens，占据 50% 以上的上下文窗口。

MCP 上下文占用：

Skills 的优势：

• 消除重复上下文：MCP 每次调用都是无状态的，Claude 不会"记住"你的偏好。Skills 将工作流程固化为文件，无需每次对话都重复解释项目规范、编码风格、审查标准。

• 零基础设施依赖：MCP 需要运行服务器进程，涉及端口、认证、进程管理等运维问题。Skills 只是文件夹里的 Markdown，Git 提交即分发，团队成员自动同步。

• Prompt 工程的最佳载体：Skills 本质是"prompt-based meta-tool"，将专家经验编码为可复用的指令集。相比 MCP 的工具调用，Skills 更贴近 LLM 的原生工作方式。

• 开放标准的胜利：Anthropic 已将 Agent Skills 发布为开放标准，VS Code、Cursor、GitHub Copilot 等主流工具均已支持。这意味着你写的 Skill 可以在任何兼容的 AI 编辑器中使用。

协作模式：

两者并非互斥，而是互补：

flowchart LR
    A[Skills] --> B[定义工作流程]
    B --> C[调用 MCP 工具]
    C --> D[执行外部操作]

• Skills 负责"怎么做"：定义审查流程、部署步骤、代码规范
• MCP 负责"做什么"：连接数据库、调用 API、操作文件系统

Skills 包装 MCP：

以 Context7 文档查询为例，创建 ~/.claude/skills/context7/SKILL.md：

---
name: context7
description: 查询第三方库的最新文档和代码示例
disable-model-invocation: true
---

使用 MCPorter 调用 Context7 MCP 查询文档：

## 步骤

1. 解析库 ID：`npx mcporter call context7.resolve-library-id libraryName:$0`
2. 查询文档：`npx mcporter call context7.get-library-docs context7CompatibleLibraryID:<library-id> topic:$1`

## 示例

查询 Spring Boot 的 WebFlux 文档：

/context7 spring-boot webflux

执行命令：
npx mcporter call context7.resolve-library-id libraryName:spring-boot
npx mcporter call context7.get-library-docs context7CompatibleLibraryID:/spring-projects/spring-boot topic:webflux

效果对比：